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GLOSSARY 

Abbreviation of PRIMOS Commands 

The minimum required abbreviation of a PRIMOS com- 
mand is shown in rust colored letters. Only internal com- 
mands can be abbreviated. 

binary file 

A translation of source tile generated by a language trans- 
lator (PMA, COBOL, FTN, RPG). Such files are in the for- 
mat required as input to the linking loader or segmented 
loader. 

byte 

8 bits; 1 ASCII character. 

braces i \ 

Of group of words or parameters enclosed in braces, at 

least one must appear in command. 

communication subsystems 

The following PRIMOS commands invoke communica- 
tions subsystems. Refer to the HASP and RJE2780 guides 
for further information. 
HASP RJSEND 

RJCNTL RJRECV 

DBMS subsystems 

The following PRIMOS commands invoke data base man- 
agement subsystems. Refer to the DBMS guides for fur- 
ther information. 
CDML DBMS 

CLUP FDML 

CSUB FSUBS 

DBACP 



' devno 

^ A device number. See pdisk 
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directory 

A special type of filecontainingalist of filenamesorother 
directories, along with information on their character- 
istics and location. A directory may be the MFD, a UFD or 
a sub-UFD. Directories with names in the MFD are UFDs; 
all other directories are sub-UFDs. 



directory-chain 

Part of a pathname; a series of directories and optional 
passwords separated by the > symbol, as in: 
directory [password] [>8ubdirectory [password]] . . . 

external command 

A command that executes in user address space. All 
external commands cause GO to print when starting. 
External commands cannot be abbreviated. 

file 

An organized collection of information stored on a disk (or 
a peripheral storage medium such as tape). Each file has 
an identifying label called a filename. 

filename 

The name of a file or directory. Filenames may be up to 32 
characters long. The first character must not be numeric 
(0-9). Filenames can be composed only of the fallowing 
characters: A-Z, 0-9, _#$&-*./. Note; On some 
devices, underline ( ) may print as back arrow {- ]. 

file-unit 

A number between 1 and 17 ('21) assigned as a pseudonym 
to an active file by PRIMOS. This number may be given in 
place of a filename in certain commands, such as CLOSE. 
PRIMOS-level internal commands require octal values. 
PRIMOS assigned units Octal Decimal 

INPUT 1 1 

LISTING 2 2 

BINARY 3 3 

COMINPUT 6 6 

SEG's loadmap 13 11 

COMOUTPUT 21 17 
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FORMS subsystems 

The following PRIMOS commands invoke FORMS 

subsystems. Refer to the FORMS guide for further 

information. 

FAP FDL 

identity 

The addressing mode plus its associated repertoire of 
computer instructions. Programs compiled in 64R mode 
execute in the R-ldentity; programs compiled in 64V mode 
execute in the V-identity. 

internal command 

A command that executes in PRIMOS space. Does not 
overwrite user memory. Internal commands can be abbre- 
viated. See abbreviation of PRIMOS commands. 

key, file protection 

Specifies file protection 

No access 

1 Read 

2 Write 

3 Read/Write 

4 Delete and truncate 

5 Delete, truncate and read 

6 Delete, truncate and write 

7 All rights 

Idisk 

The logical unit number (octal) of a disk volume. It is 
determined when the disk is brought up by a STARTUP or 
ADDISK command. 

MFD 

The Master File Directory. A special directory which con- 
tains the names of the UFDs on a particular disk or parti- 
tion. There is one MFD for each logical disk. 



mode 

An addressing scheme. The mode used determines the 
construction of the computer instructions by the 
compiler. 
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MIDAS subsystems 

The following PRIMOS commands invoke MIDAS sub- 
systems. Refer to the MIDAS guide for dialog instruc- 
tions. 

CREATK REMAKE 
KBUILD REPAIR 
KIDDEL 

nodename 

Name of a system on a network; assigned by CONFIG 
command when local system is started up. 

object file 
See binary file 

output stream 

Output from the computer that would usually be printed 
at a terminal during command execution, but which is 
written to a file if COMOUTPUT command was given. 

packname 

See volume-name 

page 

A block of 1024 16-bit words within a segment (512 words 
on Prime 300] 

parentheses ( ) 

A word or parameter enclosed in parentheses must appear 
along with the enclosing parentheses. 



partition 

A portion (or all] of a multihead disk pack. Each partition 
is treated by PRIMOS as a separate physical device. Par- 
titions are an integral number of heads in size, offset an 
even number of heads from top of the disk pack. A disk 
partition is also a volume. 
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pathname 

A chain of directories starting with the disk volume name 
and ending with the name of the directory containing the 
files to be accessed. Its format is: 

{<volurae> \ 
<ldisk> > directory- chain 
<*> j 
<volume> is the name of the disks <ldi8k> is a logical 
disk number (see Idisk) and <*> represents the current 
volume. Note; the angle brackets are required. 

pdisk 

A physical disk unit number. 

phantom user 

A command file running independently of a terminal 
under control of the PHANTOM command. 

PRIMOS 

Prime's family of single-user and multi-user disk oper- 
ating systems. 

runfile 

The executable version of a program consisting of the 
binary file, subroutines and library entries used by the 
program, COMMON areas, initial settings, etc. This file is 
created using LOAD or SEG. 

SEG 

Prime's segmentation utility 

segment 

A 64,536-word block of addressing space. 

segno 

Segment number 

source file 

A program file consisting of text, program statements, 
comments, etc. 



square brackets [ ] 

A word or parameter enclosed in square brackets is 
optional. 

8ub-UFD 

A directory which is in a UFD or other sub-UFD. 



System operator commands 

The following PRIMOS commands are for the system 
operator. Most of these commands can only be issued 
from the system console. Refer to the System Admin- 
istrators Guide for further information. 



ADDrSK 


MAKE 


AMLC 


MAXSCH 


CHAP 


MAXUSR 


CONFIG 


OPRPRI 


COPY 


SETIME 


FIXRAT 


SHARE 


ELIGTS 


SHUTDN 


LOGPRT 


STARTUP 


LOOK 


USRASR 



treename 

The complete description of a directory tree, starting with 
a specified disk volume or partition and ending with a file- 
name. The genera] format of a treename is: 

pathname > filename 

UFD 

A User File Directory, one of the directories listed in the 
MFD of a disk or partition. It may be used as a LOGIN 
name. 

volume 

A self-sufficient unit of disk storage, including an MFD, a 
disk record availability table, and associated files and 
directories. A volume may occupy a complete disk pack or 
be a partition within a multi-head disk pack. 

volume-name 

A name assigned by the MAKE operation when a disk vol- 
ume is created. 



PRIMOS 



PRIMOS COMMANDS 

/* [comment] 

Allows comment lines in command files. See COMINPUT 

and COMOUTPUT. Interna!, 

ASRCWD number 

Changes virtual control word which selects a device for 
effective output. Not PR/MOS 11. Internal 
number device 

User terminal (port 1) default 

2 Printer-2 (port 3) 

4 Printer-l (port 2) 

device I -WAIT] 

DISK pdcv [-WAIT] 

AMLC [protocol] amlc-line [config] 

SMLC [-WAIT] smlc-line 

Gives user complete control over a disk or other peri- 
pheral device. Not PRIMOS fl. internol. 
-WAIT queues ASSIGN request until device is UN- 
ASSIGNed. (Abort via CONTROL-P.) Up to 10 disk 
drives may be ASSIGNed at the same time. 
device 

Serial card reader [amlc line 6] 

Printer 1 [SOC port 2] 

Printer 2 [SOC port 3] 

MPC parallel card reader-n 

Magnetic tape drive [0-7] 

MPC parallel interface line printer n 

Paper tape reader 

Paper tape punch 

Printer-plotter 

Communications line 0-3 



ASSIGN 



CARDR 

CENPR 

CE2PR 

CRn 

MTn 

PRn 

PTR 

PUNCH 

PLOT 

SMLCOO-03 

protocol 

TTY 

TTYHS 

TRAN 



Normal terminal 

TTY with per-character interrupt 

Transparent (no character conversion) 



ATTACH 
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TRANHS 


TRAN with per-character interrupt 


TTYNOP 


Ignore all traffic 


config 




2033 


110 Baud 


2213 


300 Baud 


2323 


1200 Baud [default] 


2413 


Programmable clock [default=9600] 



ATTACH directory [password] [Idislt] [key] 

Attaches to UFD or sub-UFD as current directory. Non- 
owner passwords may be given for PRIMOS III, IV, V 
only. Internal. 

Idisk 

thru n Search specified logical disk. 

100000 Search all disks in logical order (default) 

177777 Search MFD of current disk 

key 

177777 Attach to UFD, don't change home. 

(default) Attach to UFD, set as home. 

1 Attach to sub-UFD in current direc- 
tory, do not set home 

2 Attach to sub-UFd in current direc- 
tory, set as home 

packname 

* 

ONE 
AVAIL 



1 SEVENTEEN 

Displays disk usage statistics. Shows (in decimal) num- 
ber of disk records available for use and percentage of 
space used in specified logical disk. *=all started disks. 
Externa). Default = current disk. 

BASIC [filename] 

Invokes Prime interpretive BASIC. Internal. 

BASICV [filename] 

Invokes compiled virtual-memory BASIC. See 
BASIC/VM guide. 
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BASINP filename 

Loads non-Prime standard BASIC program from paper 
tape into filename. Extcriiai. 

BINARY filename 

Opens filename for writing on file unit 3 for output. 

Equivalent to OPEN filename 3 2. Internal. 

{filename) 
ALL I [file-unit] . . . [file-unit] 

Closes specified files and file units (except a COMOUT- 
PUT file which is closed by COMO-E). Retrieves buffers 
and resets file system. Interna). 

CMPF treenaftie-1 treename-2 [. . . treename-5] [option] 

Compares lines in up to five compressed ASCII files, 
showing insertions/changes/deletions from treename-1. 

External. 



-LISTING 



Options: 
-BRIEF 

-MINL number 



Supresses display of 
differing lines 

Sets minimum number of lines 
that must match (defau/t=3) 
-REPORT filename Sends output to filename. 

CMPRES filename-l [filename-2] 

Compresses ASCII file. Inverse of EXPAND. External. 
ObsoJeto. 

CNAME old-name new-name 

Changes name of file or directory. Requires owner status 
for PRIMOS III, IV or V. Internal. 

j treename [option-1 . . . option-n] ^ 

COBOL I [option-1] -INPUT treename [. . . option-n] J 
Invokes COBOL compiler. External. 
Options: 

I treename I 
NO > 

[YES] J 
Specifies binary (object) file. 
-INPUT treename 
Specifies input source file. 



' treename^ 
NO 
[YES] 
SPOOL 

VTTY 



Specifies the listing file. 

-64R 

Generate object code to run in 64R mode. 

-64V 

Generate object code to run in 64V mode. 

-NOEXPLIST 

List source code with line numbers. Default. 

-EXPLIST 

Expanded listing. Machine generated labels replace 

user-defined names. 64V mode only. 

COMINPUT option 

Reads command input from filename instead of terminal. 
Default: file-unit=6. Internal. 

Options: 
filename [file-unit] 

Read command input from filename and optional file- 
unit. 
-CONTINUE 

Continue original command filename. 

-END 

Return to terminal input. 

-PAUSE 

Return to PRIMOS from current command filename. 

-START 

Restart after CONTROL-P or WARM START. Use 

-CONTINUE for all other cases. 

-TTY 

Take input from terminal. 

Note.s: 

1. CLOSE ALL will close the COMINPUT file- 
unit, causing COMINP FILE EOF. 

2. Insert comments in file with /* comment 
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COMOUTPUT option 

Sends output stream to specified filename or file opened 
on unit 17. At least one option must be specified. Not 
closed by CLOSE ALL. Not PRIMOS II. Internal. 

Options: 

[filename-l] 

Send output to filename-l. 

-CONTINUE [filename-2] 

Continue output, overwriting filename-l if fiIename-2 

not specified. 

-END 

Close output file. Used instead of CLOSE. 

-NTTY 

Turn off terminal output including OK prompt. 

-PAUSE 

Stop output but do not close filename-l 

-TTY 

Turn on terminal output. 

CPMPC treename [options] 

Punches file on ASSIGNed card reader/punch. Does not 
punch EOF ($E) card. Not PRIMOS 11. ExlornaJ. 

Options: 

-CRn Card-reader/punch-n 

PRINT Display cards on terminal and 

interpret while punching. 

CREATE directory-name 

Creates new UFD in MFD or sub-UFD in current directory 
with owner password blank, non-owner password zero 
and protection keys 7 0. Internal. 



CRMPC treename [options] 

Reads cards from parallel interface reader connected to 
MPC controller and loads card image ASCII data into file 
specified until: 1. End of deck; 2. SE in columns 1 and 2; 
3. Card-reader/punch STOP button hit. Not PRIMOS II. 
External. 
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Options: 

-CRn 

-PRINT 



Card-reader/punch-n 
Displays cards at terminal 



CRSER filename 

Reads cards from serial interface card reader into file- 
name. Externa/. Not PRIMOS 11. 



CX 



[-ON Idisk] 



(filename I 
option I 

Invokes sequential phantom job processor. 
Options: 

-A List entire audit file 

-Dn Drop job number n 

-P List user jobs in queue and audit file 

-Q List queue (running and pending jobs) 

-Sn List status of job number n 

-ON Idisk Perform operation on local logical device 
Idisk, a remote disk. 

DATE 

Displays the current date and time. Not PRIMOS II. 
External. 

DBASIC [filename] 

Invokes double-precision interpretive BASIC. 

DELAY [minimum] [maximum] [r-margin] 

Sets terminal delay characteristics. Can be set prior to 
LOGIN. Not Primes II. Defaults: minimum=6, maxi- 
mum=12 r-margin=72. These are for 30 CPS terminals. 

DELETE filename 

Deletes filename from current directory. Filename can be 
either a file or an empty directory. (For non-empty direc- 
tories use FUTIL TREDEL or UFDDEL.) 



DELSEG 



( segno I 
lALL J 



Deassigns a segment. ALL releases all segments belonging 
to user. Internal. PRIMOS IV, V only. 
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ED [filename] 

Invokes the EDITOR sub-system. See the section on 
EDITOR commands at the back of this guide. 

EDB 

Invokes the binary editor subsystem. See the section on 
binary editor commands at the back of this guide. 

EXPAND [filename-l] [filename-2] 

Reverse of CMPRES. Maximum line size=720. ExtornaJ. 

FILEMEM [ALL] 

Clears user address space for unsegmented programs. On 
PRIMOS II will clear locations '100 through '47777, except 
those occupied by PRIMOS II itself. On PRIMOS III, IV 
and V will clear locations '100 through '77777. Using 
FILMEM ALL will: clear all user space on PRIMOS II, 
except that occupied by PRIMOS II, clear locations '100 
through '177777 on PRIMOS III, IV and V. Externa/. 

FILVER [filename-l] [filename-2] 

Compares two ASCII files for equivalence. Not PRJMOS 
11. External. 



FTN 

Invokes Prime FORTRAN IV compiler. See the section on 
FTN at the back of this guide. 

FUTIL 

Invokes the file manipulation utility. See the FUTIL sec- 
tion at the back of this guide. 

HPSD 

Loads version of Prime's symbolic debugger stored in 
upper portion of memory. Refer to the section on PSD at 
the back of this guide. 

INPUT filename 

Opens filename for reading on file unit 1. Equivalent to 

OPEN filename 1 1. Internal. 
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LABEL MTn -VOLID volume-id -OWNER owner-id 
-ALL access 

Creates an ANSI COBOL level 1 volume label on a 
magnetic tape. Not PRIMOS /(. External. 

n unit number of tape drive (0-7) 

volume-id 1-6 character string 

owner-id 1-14 character string (default is the 

LOGIN name) 
access 1-character access indicator. Ignored by 

PRIMOS. Defaull=blank 



LATE 

Requests time of day in HHMM format when next com- 
mand is to be processed. Terminal cannot be used for any 
other purpose until after time specified (escape via CON- 
TROL-?). Not PR/MOS JI. External. 

LISTF 

Displays current directory name, logical device and 
names of all files, sub-UFDs and segment directories in 
current directory. PRIMOS III, IV and V also display 
owner/non-owner status as "O" or "N". Interna/. 

LISTING filename 

Opens filename for writing on file unit 2. Equivalent to 

OPEN filename 2 2. Interna/. 

LOAD 

Invokes the LOAD subsystem. See the section on LOAD at 
the back of this guide. 

LOGIN ufd-name [password] [logical-device] [-ON node- 
name] 

Log in to specified ufd-name. Not PHIMOS JJ. Logs user 
out if one currently logged in at terminal. 

LOGOUT [-user] 

Log out user or phantom user. Not PHIMOS II. Interna/. 



MACHK 

Turns on machine check mode. Only PRIMOS I/, /nterna/, 
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MAGNET 

Invokes the magnetic tape utility. See the section on 
MAGNET at the back of this guide. 

MAGRST 

Invokes the magnetic tape restore utility. See the 
MAGRST section at the back of this guide. 

MAGSAV 

Invokes the magnetic tape save utility. See the section on 
MAGSAV at the back of this guide. 

MCG filename 

Translates assembled microcode in filename for ROM 
simulator. External, 

MDL 

Memory dump/load to/from punched paper tape. 

MESSAGE [nodename] 

Waits for one line of text and sends it to operator's console 
of specified system. Not PRIMOS 11. Internal. 

MRGF treename-1 treename-2 [. . . treename-5] outtree- 
name [option-1 . . . option-n] 

Merges ASCII files into specified outtreename. External. 

NUMBER 

Numbers/re-numbers statements in a BASIC program. 
Requests intreename, outtreename and starting statement 
number (1-9999). ExtcrnoJ. 

OPEN filename unit key 
Opens filename on specified unit. Interna/. 
keys: 

1 Read IQOO New SAM 

2 Write 2000 New DAM 

3 Read/v\frite 4000 New SAM segment 

4 Close 6000 New DAM segment 

5 Delete 10000 New UFD 

6 Exist 

7 Rewind 
10 Truncate 
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PASSWD [owner-password] [non-owner-password] 
Resets owner and non-owner-passwords for current 
directory. PRIMOS II owner passwords only. Internal. 
Defaults: blank owner, non-owner. 

PHANTOM command-inputfile [file-unit] 

Runs specified command-inputfile as a phantom user. 
Default: file-unit=6 

PM 

Displays contents of RVEC vector or user register vector. 
Internal. 

PMA 

Invokes Prime Macro Assembler. See section on PMA at 
the back of this guide. 

PRERR 

Displays ERRVEC message set by ERRSET and first six 
octal location in ERRVEC or prints ERRVEC and last error 
message. Internal. PRIMOS II, III Obsolete. 

PRMPC treename 

Prints treename on MPC parallel interface printer pre- 
viously ASSIGNed. External. 

PROTEC filename [owner-rights] [nonowner-rights] 

Sets protection rights on filename. Not PRIMOS II. 
Internal. Default: 
Rights: 

No access 4 Delete/truncate 

1 Read 5 Delete/truncate/read 

2 Write 6 Delete/truncate/write 

3 Read/Write 7 ALL 

PRSER treename 

Prints treename on serial interface printer previously 

ASSIGNed. External. 

PRVER treename 

Prints treename on a configured printer/plotter. Refer to 

PRMPC. Not PRIMOS II. External. 
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PSD 

Invokes Prime Symbolic debugger. See section on PSD at 
the back of this guide. 

PTCPY 

Duplicates and verifys paper tape. Reader and punch 
must have been previously ASSIGNed for PRIMOS III, 
IV, V. Externa). 

RESTORE filename [start-address] [end-address] [p] [a] 
[b] [X] [keys] 

Restores runfile contained in filename into memory. 
JnternaJ. 

RESUME filename [p] [a] [b] [x] [keys] 

Runs (restores and starts) external program contained in 
filename. JnternaJ. 

RPG 

Invokes Prime RPG II language compiler. Refer to RPGII 
guide. 

RUNOFF 

Invokes Prime RUNOFF text processor. Refer to the New 
User's Guide to EDITOR and RUNOFF for further 
information. 

SAVE filename start-address end-address [a] [b] [x] 
[keys] 

Saves memory image/contents from specified start- 
address to end-address. Do not use with 64V segmented 
run files. IntornoJ. Also see SEG SAVE. Default: Previous 
RVEC contents. 



SEG 

Invokes Prime segmented loader. See the section on SEG 
at the back of this guide. 

SIZE treename 

Displays data size of treename in records. Record is data- 
words/440, rounded up. External. 
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SLIST filename 

Prints (displays) filename at user's terminal. External. 

SORT [option-1] [option-2] 

Sorts an ASCII file. Requests name of input and output 
files, number of fields and columns delimiting fields. 
Maximum number of SORT fields = 10. Maximum number 
of characters/record=144. To sort in reverse specify R 
after closing column in field. Upper and lower case char- 
acters are sorted identically. External. 
Options: 

-BRIEF Suppress SORT request for values 

-SPACE Delete blank lines from output file 
-MERGE Merge indicated files (maximum=10) 

SPOOL 

Places file in queue for line printer. See section on SPOOL 
at the back of this guide. Not PRIMOS II. External. 

SPSS 

Invokes Prime's SPSS subsystem. PHIMOS IV, V only. 
Externa;. See SPSS guide. 

START [location] [a] [b] [x] [keys] 

Starts execution, initializes process registers and keys 
and starts execution from location. Assumes that pro- 
gram is in memory. If location not specified, execution 
resumes at point of interruption. Internal. 



/ [ALL] 

I DISKS 
STATUS { USERS 

I NET 

I UNITS , 

Displays user of system status. Lists for LOGIN UFD's: 
logical device, open file units, physical/logical device cor- 
respondence and physical device numbers. In PRIMOS 11 
also shows lower boundary and buffers. PRIMOS III, IV, 
V, disk packnames also printed. External. (PRIMOS II) 
Internal [PRIMOS III, IV, V). Defaults: information about 
disks, units and network. 
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I'?} 



Sets SVC switch, controls SVC instruction handling in 
virtual memory environments. Znternal. Allows VDOS32 
to run under PRIMOS III, IV, V. 

Traps SVC's for processing by PRIMOS 

1 Virtual traps SVC's for processing through 
user location '65. 

TA pathname 

Tree attach to directory location specified by pathname. 
Sets new directory to home. ExfernoJ. 

TAP 

Invokes Prime' Octal Mode debugger. See section on TAP 
at the back of this guide. Externai. 

TDOS64 

Runs virtual memory PRIMOS II under PRIMOS III, IV 
and V. Not PRIMOS U. External. 

TERM option-1 . . . option-n 

Sets terminal characteristics (resets to default explicitly 
or via LOGOUT). Not PRIMOS H. ExtornaJ. 
Options 
-BREAK |[ON]\ Enable/disable BREAK key 

I off/ equivalent to Control-P. 
-DISPLAY Display current terminal char- 

acteristics. 
-ERASE character Set new PRIMOS erase character. 
-FULL Full duplex mode (default] 

-HALF r [-LF]) Half duplex mode [-LF]=DO LF 

i-NOLFj when CR hit); -NOLF=don't 
-KILL character Set new PRIMOS Kill character. 
-NOXOFF Disable Control-S/Control-Q 

functions. 
-XOFF Enable Control-S/Control-Q 

functions for inspection of screen 
output. (Hit Control-S to halt 
terminal output, Control-Q to 
resume.) 
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TIME 

Displays current values in the time accounting registers. 
Not PHIMOS U. Interna). 



™..,.^ /transmit! 

TRAMLC {receive / 



filename amic-line [T] 



Transmits/receives filename over specified amlc-line 
between compatible systems. Not PRIMOS II. External T 
displays milestone messages. 



UNASSIGN 



(device [-WAIT} \ 

DISK pdev [-WAIT] I 

AMLC [-protocal] amlc-line [config] | 
SMLC [-WAIT1 smlc-line } 

Releases peripheral device (or communications line) pre- 
viously ASSIGNed. See ASSIGN for parameters values. 
Not PHIMOS II. Internal. 

UPCASE intreename [outtreename] 

Replaces all lower case letters in intreename with upper 
case letters. Output goes to outtreename or file open on 
unit 2. ExtornaJ. 

USERS 

Displays number of current users. Not PRIMOS U. 
Internal. 

VPSD 

Virtual mode symbolic debugger. See section on PSD at 
the back of this guide for information. 

VRTSSW octal-number 

Sets virtual sense switches. WARNING: skip and sense 
switch instructions refer to actual not virtual sense 
switches. Not PRIMOS II. Internal. Defoult: octal- 
number^O 



PRIMOS SUBSYSTEMS 

DEBUGGING UTILITIES (TAP, PSD, VPSD) 

For S and R mode programs. Load the object program, 
using the PRIMOS commands LOAD or RESTORE, and 
then choose which version you need. Since the debug 
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utility is resident in user memory with your program, 
make sure your program is not overlaid. For V-Mode pro- 
grams, load using SEG and then run by saying SEG 
filename 1/1. Type the VE command to VPSD to obtain its 
resident address. 

Terminating long operations: To terminate long opera- 
tions such as DUMP, type CTRL-P to return to PRIMOS 
command level. 

Restarting: Restart at the version's starting address. To 
determine this value, type a VERSION command to print 
the starting location. (For TAP, return to PRIMOS and do 
a PM.) 

PSD/VPSD input/output formats: The format is estab- 
lished by ending any command with a colon followed by a 
single letter, as in; A lOOO.O. 

:A ASCII 

B Binary 

D Decimal 

H Hexadecimal 

O Octal 

S Symbolic 

L Long integer (VPSD only) 

P AP 

Expressions: only + and - operators. No literals. Symbol 
use: global symbols if the LS procedure has been used or 
any symbols defined within PSD. Symbolic input is only 
legal in access mode — i.e., "S 100 200:SAIA" is not legal. 
Constants entered in :S mode are octal. 
Command Line Operands: These may be constants, con- 
stant expressions, or symbols. The format of a constant is: 
[: format] (>] | tdigits \ [:format] 

\ ASCII-constant) 
>=relocatable mode 



Access Mode Terminators: 
TAP, PSD, VPSD 

CR Move to next location 

t Move to current location -1 

? Exit from access mode; do not change con- 

tents of current location 



PSD, VPSD ONLY 

.n (CR) Move to current location +n. 

.-n (CR) Move to current location -n. 

@ Move to location addressed by instruction 

in current location. 
( Move to location addressed by instruction 

in current location without following 

indirects 
/ Return to the address of the last (5) 

) Return to the address of the last ( 

= Calculate and print effective address and 

its contents 
! Set current location to new contents and 

exit from access mode. 

Subcommands: [input rust letters in upper-case ONI^Y] 

ACCESS address (TAP] 

Accesses address in memory and waits for keyboard 
input in the form; 

[value] tap terminator 
ACCESS address fPSD. VVSU] 

Accesses address in the current segment and waits for 
keyboard input in the following form: 
[:format-symbol] [value] [:new-format] terminator 
BR (VPSD) 

Prints the contents of the procedure base, stack base, link 
base and temporary base registers. 
BREAKPOINT location 
Sets a breakpoint at the specified location. 
COPY blockstart block-end target 

Copies a block of memory to a new location starting at 
target. 

DEFINE symbol value (PSD) 

Assigns a value to an alphanumeric symbol. 
DUMP block-start block-end [words-per-line] 
Prints the contents of a block of memory on the terminal 
or, optionally, to a file previously OPENed with no para- 
meters. 
EFFECTIVE block-start block-end (PSD, VPSD) 

address [mask] 
Searches for an instruction with the specified effective 
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address in the specified block, under an optional mask. 
The current values of the register are used. 
EXECUTE address [a] [b] [x] (TAP) 

Executes the S- or R-mode subroutine at the specified 
address. 

EXECUTE (VPSD) 

Executes a segmented program by passing control to SEG. 
FILL block-start block-end constant 
Fills a memory block with the specified constant. 
GO [count] [a] [b] [x] [keys] (PSD) 

Proceeds from the current breakpoint. Count is the num- 
ber of times to execute breakpoint location. 
JUMPTRACE [start-add] [a] [bj fTAP, PSD] 

Executes the object program and produces a diagnostic 
printout prior to execution of JMP, JST or HLT instruc- 
tion. SVC's are not traced. Printout is: 

Location: instruction A= B= X= K= R= 
KEYS value fPSD, VPSD] 

Sets CPU status keys to octal value. 



LB seg-no word-no fVPSD] 

Loads the link base register with a segment number and 
word number. 
LIST address 

Prints the contents of address in the current output 
format. (Does not move pointer.) 

LS (PSD) 

Enables the use of load map symbols. Load program and 

use map 10 option to create symbol file, restore program 

and invoke PSD, open VPSD symbol file on any unit for 

reading, give LS command, and close unit. 

MAP 

Prints load map symbols and definitions. 

'd16S^ (PSD, VPSD] 

D32S I 

032R I 

D64R/ 

D64V| 

,D32I / 
Sets address mode. 



(PSD) 
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MONITOR [start-add] [a] [b] address (TAP, PSD) 

Traces the object program for a memory reference instruc- 
tion whose effective address equals address. 
NOT-EQUAL block-start block-end n-match [mask] 
Searches memory block for words not equal to n-match 
under an optional mask [a 16-bit logical AND). 
OPEN filename file-unit key (PSD, VPSD) 

Opens a file to be used either as a DUMP output file or 
symbol table input file. Filename must be < six char- 
acters. Key is the same as for PRIMOS OPEN. 
PATCH patch-loc branch-loc (TAP) 

Replaces instruction at branch-loc by a jump to patch-loc, 
inserts the previous contents of branch-loc at patch-loc 
and enters ACCESS at patch-loc so you can key in a patch 
and return. Patch-loc must either be in the same sector as 
branch-loc or in sector 0. 

PRINT (PSD, VPSD) 

Prints CPU/PSD parameters in octal as follows: 
p: breakpoint a b x keys relcon 

PROCEED [address] [a] [b] [x] [keys] (PSD, VPSD) 

Removes the current breakpoint, optionally sets a new 

breakpoint at address, and resumes execution. 

QUIT (PSD, VPSD] 

Returns to PRIMOS, (or SEG for SEG's VPSD), 

RELOCATE value 

Sets a new value for the access-mode relocation counter. 

RUN [start-add] [a] [b] [x] [keys] 

Runs the executable program starting at start-add. 

SB seg-no word-no (VPSD) 

Loads the stack base register with a segment number and 

a word number. 

SEARCH block-start block-end match-word [mask] 

Searches memory block for words equal to match-word 
under an optional mask. 

SN seg-no (VPSD] 

Sets a segment number for all commands where only a 
word number is entered, such as UPDATE, DUMP, etc. 
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TRACE [start-add] [a] [b] 



Controls the use of symbols in address typeout. 1 = sym- 
bols, = no symbols. 

rfp-vai[o] n 

|_\ -1 interval J J 

Dynamically traces program by interpretive execution of 

each instruction and diagnostic printout. P-val causes 

printout only when program counter = p-val. P-val 

means printout the first time program counter = p-val and 

every instruction thereafter. -1 interval means printout 

every interval instructions. HLT instructions always 

cause printout followed by return to command mode. 

UPDATE location contents 

Puts contents into location and prints the old and new 

contents. 

VERIFY block-start block-end copy 

Verifies block of memory by comparing it with another 

block starting at copy. Locations that do not match are 

displayed as: 

location block-contents copy-contents 
VERSION fPSD. VPSD) 

Prints the version number and restart address of the 
utility as an aid in restarting. 

WHERE (PSD, VPSD) 

Lists all currently installed breakpoints and their 
remaining proceed counts. A proceed count of 1 is not 
listed. 

XB seg-no word-no (VPSD) 

Loads temporary base register with a segment number 
and word number. 

XR value (VPSDJ 

Loads the X register with value. 

YR value (VPSD) 

Loads value into the Y index register [P350 and up). 
ZERO [location] (PSD, VPSDJ 

Removes breakpoint at specified location or the break- 
point at the current program-counter location. 
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EDITOR SUBSYSTEM 
ED [filename] 

Edits existing or new file. Carriage return inputs a line 
from the terminal. For more information refer to the NEW 
USER'S GUIDE TO EDITOR AND RUNOFF. 
Defaults: 

Erase character " 

Kill character ? 

Tab character \ 

Default tab settings 6, 12, 30 

Command /input line 
terminators ; or carriage return 

EDITOR SUBCOMMANDS 
APPEND string 

Appends string to end of current line. 
BOTTOM 

Moves pointer to bottom of work file, 
BRIEF 

Suppresses verification output. 
CHANGE/string-l/string-2/[G] [n] 

Replaces string-1 with string-2, on n lines once or gen- 
erally, [G]. 
DELETE [n] 
Deletes n lines. 
DELETE TO string 

Deletes lines from file until string is found. 
DUNLOAD filename [n] 
Copies and deletes n lines from file. 
DUNLOAD filename TO string 
Copies and deletes line until string is found. 
ERASE character 

Makes character new erase character. 
FILE [filename] 

Files work file under filename or current filename. 
FIND string 

Finds first line below current containing string, 
FIND{n) string 

Finds first line below current containing string in column 
n. 
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GMODIFY 

Alters current line as specified. See RUNOFF guide, 

Section 8. 

Subcommands: 

A/string/ Copy current line and append string 

B n Move pointer back n spaces 

C character Copy up to but not including character 

D character Skip up to but not including character 

E n Skip next n characters 

F Copy to end of line 

I/string/ Insert string starting at current 

column 
M n Copy n characters 

n Test tor "not character" in next C or 

D command 
O/string/ Overlay string starting at current 

column 
R/string/ Retype, using string, from current 

column 
S Move pointer to column 1 

INPUT device 

Takes input from either (ASR], (PTR), or (TTY) (default) 

device. 

INSERT newline 

Inserts newline below current line. 

KILL character 

Makes character new kill character. 

LINESZ [n] 

Makes n maximum line length. 

LOAD filename 

Copies filename into workfile. 

LOCATE string 

Finds first line below current line containing string. 

MODE COLUMN 

Displays banner at start of INPUT Mode. 

MODE NCOLUMN 

De-activates column banner fdefauJt). 

{BLANKS ) 
ZEROES \ 
suppress) 

Activates counter symbol with these values. 



MODE NCOUNT 

De-activates counter. 

MODE NUMBER 

Activates printing of line numbers. 

MODE NNUMBER 

De-activates printing of line numbers fdefauJt). 

MODE PROMPT 

Displays prompts for INPUT and EDIT Modes. 

MODE NPROMPT 

De-activates Mode prompts (default}. 

Mode prall 

Do not flag character case (defauJtJ. 

MODE PRUPPER 

Treat as case-flagged uppers, line default upper. 

MODE PRLOWER 

Treat as case-flagged uppers, line default lower. 

MODIFY /string-l/string-2/[G] [n] 

Changes string-1 to string-2 without changing line 

alignment. 



MOVE buffer-1 (^"""rf] 
i /string/ ) 



Moves string or contents of buffer-2 into buffer-1. 

NEXT(n) 

Moves pointer n lines. 

NFIND(n) string 

Moves pointer to next line not containing string. 

OUTPUT 11?^"/,"^^') 

Sends verification output to specified device [default = 

TTY). 

OVERLAY string 

Superimposes string on current line. 

PAUSE 

Freezes EDIT session, goes to PRIMOS-level (return via 

START). 

POINT n 

Moves pointer to line n. 

PRINT [n] 

If n>0, prints n lines; if n<0, backs up n lines and prints 

one line. 
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PSYMBOL 

Prints list of current reserved characters. 
PTABSET ptab-1 ptab-2 . . . 

These are current physical tab stops on device. 

PUNCH [n] {[ptJ/I 

Punches n lines on indicated device. 

QUIT 

Leaves EDITOR without saving results of session. 

RETYPE string 

Deletes current line, replace Vifith string. 

SYMBOL name character 

Makes character current value of symbol name. 

Special Symbol Name Character 

KILL ■ ? 

ERASE 

WILD ! 

BLANKS # 

TAB \ 

ESCAPE t 

CPROMPT $ 

DPROMPT & 

SEMICOLON ; 

COUNTER (3) 

TABSET tab-1 tab-2 . . . tab-8 

Sets these logical tab stops for EDITOR tab symbol. 
TOP 

Moves pointer to top of file. 
UNLOAD filename [n] 
Copies n lines into filename. 
UNLOAD filename TO string 
Copies lines into filename until string is found. 

VERIFY 

Turns on verification output [default], 

WHERE 

Prints current line number. 

XEQ buffer 

Executes contents of buffer as a command line. 



*[n] 

Repeats preceding commands on line either n times or 
until TOP/BOTTOM reached. 



I output-file I 



COPY 



FIND 



BINARY EDITOR 

FOB {•nP«t-f''el 

*•"" \ (PTR) I \ (PTR) 

The binary editor is used mainly for building and main- 
taining subroutine libraries, (PTR) = paper-tape input or 
output. For more information refer to the Software 
Library manual. 
Subcommands: 
BRIEF 
Suppresses display of subroutine names and entry points. 

(filename I 
ALL I 

Copies main programs and subroutines, from EDB pointer 
up to filename or end of infile. 

{filename I 
ALL ) 

Moves pointer to subroutine filename or end of infile. In 
VERIFY mode, display subroutine and entry names. 
INSERT treename 

Copies treename to outfile (pointer unchanged). 
NEWINF treename 

Closes outfile, opens treename as new input file. 
OPEN treename 

Closes outfile, opens treename as new output file. 
QUIT 

Closes all files, returns to PRIMOS. 
REPLAC name treename 

Replaces subroutine name or containing name with tree- 
name. 

RFL 

Writes reset forceload flag block in outfile. 

SFL 

Writes set forceload flag block in outfile. 

TERSE 

Enters terse mode (displays first entry point onJy). 

TOP 

Moves pointer to top of file. 
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VERIFY 

Enters VERIFY mode (displays all subroutine names and 
entry points). (Default). 



FTN 



FORTRAN IV COMPILER 

treename [options] 1 

[option] -INPUT treename [options] J 

Invokes FORTRAN compiler. For more information refer 
to the FORTRAN Programmer's Guide. 
Options: (• - indicates Prime-supplied defaults) 
Specify Input/Output Devices 

^treename\ 
-BINARY \ NO \ 

{ [YES] ) 
Specifies binary (object) file. 
-INPUT treename 
Specifies source program file. 
treename \ 
[NO] 
-LISTING { YES 

TTY 

SPOOL ^ 
Specifies listing file. 
-SOURCE treename 
Same as INPUT. 
Enable Listings/Cross References 



-ERRLIST 

• -ERRTTY 
-EXPLIST 

• -LIST 

-NOERRTTY 

• -NOTRACE 

• -NOXREF 
-TRACE 
-XREFL 
-XREFS 

Memory Usage 
-BIG 



Print error-only listing 

Print error messages at user terminal 

Print listing including assembler 

output 

Print source program and error 

listing 

Suppress error messages to terminal 

Suppress global trace 

Suppress cross-reference listing 

Enable global trace 

Print full cross-reference listing 

Print partial cross-reference listing 

Handle arrays spanning segment 
boundaries f64V only] 



-DEBASE 
-DYNM 

• -NOBIG 

• -SAVE 

• -32R 

-64R 

-64V 

Operations 
-DCLVAR 

• -FP 

-INTL 

• -INTS 

• -NODCLVAR 
-NOFP 

-SPO 



Conserve loader base areas 

Enable dynamic allocation of local 

storage (64V only} 

No arrays spanning segment 

boundaries 

Static allocation of local storage 

Generate code to run in 32R mode. 

Generate code to run in 64R mode. 

Generate code to run in 64V mode. 



Flag undeclared variables 

Generate floating-point skip 

instructions 

INTEGER default is INTEGERM 

INTEGER default is INTEGER*2 

Do not flag undeclared variables 

Suppress generation of floating-point 

skip instructions 

Special library compilation 



FUTIL — FILE MANIPULATION UTILITY 

FUTIL is the interactive file manipulation utility. It 
responds with a prompt character, >, and waits for sub- 
commands. For more information refer to the PRIMOS 
Commands manual. 
Subcommands: 
ATTACH pathname 

Attaches to new directory; make it "home". 
CLEAN prefix [level] 

Deletes files beginning with prefix, for indicated number 
of levels fdefauJ(=3). 

COPY from-name [to-name] [,from-name [to-name]]... 
Copies named SAM or DAM files from FROM directory to 
TO directory. If to-names are omitted, copies have same 
names as originals. 
COPY (from-position) [(to-position)] 
Copies from one segment directory to another. If to- 
position is omitted, copy goes to same position as original. 
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DELETE 



FORCE 



COPYDAM 

Same as COPY but sets file type of copy to DAM. 

COPYSAM 

Same as COPY but sets file type of copy to SAM 

CREATE directory [owner-passwd [non-owner passwd]] 

Creates directory in current TO directory (with optional 

passwords). 

r file-a [file-b] ... \ 

( (position-a) [(position-b)]...| 
Deletes from FROM directory named files or, in segment 
directories, deletes files at specified positions. 

I ON \ 
\ [OFF] ) 

ON forces read-access rights in FROM for LISTF, LIST- 
SAVE, SCAN, UFDCPY and TRECPY. OFF stops FORCE 
action (default). 
FROM pathname 

Defines FROM directory for subsequent commands such 
as COPY, LISTF, etc. 
LISTF [level] JFIRST] JLSTFIL] [SIZE] 

[PROTEC] [RWLOCK] [TYPE] [DATE] 

[PASSW] 
Lists files and attributes at terminal (and into optional file 
named LSTFIL). 
LISTSAVE filename [level] [FIRST] [SIZE] 

[PROTEC] [RWLOCK] [TYPE] 
PATE] [PASSW] 
Same as LISTF, with the LSTFIL option specified, but 
writes output to filename. 

PROTECT filename [owner-access [non-owner-access]] 
Sets protection attributes for filename. 
SCAN filename [level] [FIRST] [LSTFIL] 

[SIZEI [PROTEC] [RWLOCK] 
[TYPE] [DATE] [PASSW] 
Searches FROM directory tree for all occurrences of spe- 
cified filename and prints requested attributes. 
SRWLOC filename lock-number 
Sets per-file read/write lock. 
TO pathname 

Defines TO directory for subsequent commands such as 
CREATE and all copying commands. 



TRECPY directory-a [directory-b] 

[,directory-c [directory-d]]... 

Copies directory tree(s) in FROM directory into TO 

directory. 

TREDEL directory-a [directory-b]... 

Deletes directory tree(s) in FROM directory. 

TREPRO pathname [owner-access [non-owner-access]] 

Sets protection rights for directory and contents (default 

1 0). 

TRESRW pathname lock-number 

Sets per-file read/write locks for all files in pathname, 

UFDCPY 

Copies entire FROM directory into TO directory. 

UFDDEL 

Deletes entire FROM directory. 

UFDPRO [owner-access [non-owner-access [level]]] 

Sets protection attributes for entire FROM directory. 

UFDSRW lock-number n-levels 

Sets per-file read/write lock for n-levels in FROM 

directory. 

Lock number Meaning Code 

Use system R/W lock SYS 

1 n readers OR 1 writer W/NR 

2 n readers AND 1 writer IWNR 

3 n readers AND n writer NWNR 



LOAD SUBSYSTEM 

Invokes virtual loader for loading sectored and relative 

code in one segment (64K maximum — see SEG LOAD). 

Treenames may be used to specify files except in 

ATTACH and SAVE. External. 

LOAD SUBCOMMANDS 

ATTACH [directory] [password] [Idisk] [key[ 

Attaches to specified UFD. 

AUTOMATIC base-length 

Inserts base area of specified length at end of routine if 

>'300 locations loaded since last base area. 

CHECK [symbol-name] [offset-l]...[offset-9] 

Checks value of current PBRK against symbol or number. 

Symbol-name is a 6 character symbol defined in the 
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symbol table. Offset-l thru 9 are summed to form an 
address or offset from symbol name. Numbers preceded 
by "-" are negative. 
COMMON address 

Moves top/starting COMMON location to address. 
DC [END] 

Defers definition of COMMON block. [END] turns of f DC. 
ENTIRE treename 

Saves entire state of loader as runfile, along with tem- 
porary file, for building overlays. 
ERROR n 

Determines action taken in case of load errors. 
n Meaning 

SZ errors treated as multiple indirect, others act 
as n=l. 

1 Display multiple indirects on TTY but continue 
LOAD; abort load of file for all other errors. 

2 Abort to PRIMOS 
EXECUTE [a] [bj [x] 

Starts execution with specified register values. 

[ FORCELOAD ) 
F/ i LIBRARY \ treename [parameters] 

\ LOAD j 

Forceloads all modules in specified object file. See LOAD 
for parameters. 
HARDWARE definition 

Specifies expected level of instruction execution. 
CPU Definition 

P400 57 

P300/FP 17 FP = Floating Point 

P300 3 

P200/HSA 1 HSA = High-speed 

PlOO/HSA 1 arithmetic 

P200 

PlOO 

HARDWARE, if given, must precede loading of UII 
library. 

INITIALIZE [treename] [parameters] 
Initializes LOADER and optionally does a LOAD. See 
LOAD for parameters. 



LIBRARY [treename] [loadpoint] 

Loads specified file from library UFD. 

LOAD treename [parameters] 

Loads the specified object module. The parameters may be 

entered in three formats: 

1. loadpoint [setbase-l]...[setbase-8] 

2. * [setba8e-l]...[setbase-9] 

3. symbol [setbase-l]...[setbase-9] 

In form 1 loadpoint is the starting location of the load. In 
form 2 the load starts at the current PBRK location (*). In 
form 3 the load address can be stated symbolically (sym- 
bol). The remaining numeric parameters (setbase-1, etc.) 
specify the size of linkage areas to be inserted before and 
after modules during loading. If the last parameter is 
'177777, the loader requests more setbase values. 



MAP [treename] [option] 

Generates load-state map. If treename is omitted, map is 
displayed at TTY. 



Option: 


Meaning 





Load state, base area, symbol storage map; 




symbols sorted by address (default) 


1 


Load state only 


2 


Load state and base area 


3 


Unsatisfied references only 


4 


Same as 


5 


System Programmer map 


6 


Undefined symbols, sorted alphabetic 


7 


All symbols, sorted alphabetic 


10 


Special symbol map for PSD (in a file) 




■D32R\ 




DG4R 1 


\*f^ni7 


Dies 1 


wiyjucM 


D32S ' 




D64V 




D32I 


Specifies address resolution mode for next load module 


(32K Relative is default). If used, MODE must precede 


other LOAC 


commands. 
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P/ 



PBRK 



SETBASE 



{FORCELOAD] 
LIBRARY \ [parameters] 

LOAD ) 

Begins loading at next page boundary. See LOAD for 

parameters. 

PAUSE 

Leaves loader to execute internal PRIMOS command. 

Return via START. 

(symbol-name) [offset-l]...[offset-9] I 
*offset-l [off8et-2]...[offset-9] j 
Sets a program break to value of symbol plus offset or a 
number. * treats sum of numbers as offset from current 
PBRK. Offsets 2 thru 9 may be negative. 

QUIT 

Deletes temporary file, closes map file (if loader opened 
it), and returns to PRIMOS. 

[base-start] [base-range] I 
* base-range ) 

Defines starting location and size of base area. * is current 
value of PBRK. 
SS symbol-name 

Save symbol. Exempts specified symbol from action of 
XPUNGE. 

cvMnni {symbol-name [offset-l]...[offset-6] 

i>¥lviuuL I . offset-1 [off8et-2]...[offset-6] J 

Establishes locations in memory map for common blocks, 
relocation load points, or to satisfy unsatisfied references. 
* is current value of PBRK. Offsets are summed; 2 thru 6 
may be negative. 

(yes \ 

1 i^^^ I 

Permits/prohibits links in sector zero 
VIRTUALBASE base-start to-sector 

Copies base sector to corresponding locations in to-sector. 
Used for building RTOS modules. 

MAGNET MAGNETIC TAPE UTILITY 

MAGNET is an interactive magnetic tape utility that 
transfers non-Prime-format magnetic tapes to and from 
PRIMOS disk files. MAGNET prints a release number 
and a date and then requests the user to enter an option. 



SZ 



The user may then issue one of the four option commands. 

Each option conducts a dialog. The queries and responses 

are described below. 

POSITION 

Positions the tape to a specified file and record number. 

Absolute position rewinds tape before spacing. Relative 

position allows tape to be moved forward or backward 

from the current position. 

READ 

Transfers a file from magnetic tape to disk, optionally 

providing unblocking and EBCDIC or BCD translation. 

WRITE 

Similar to READ but transfers file from disk to tape. 

WRITE also provides facilities for blocking and character 

translation. 

COPY 

Copies a file (or files) from one magnetic tape to another. 
No character translation is provided for this operation. 

MAGNET DIALOG QUERIES 

Prompt Response 

MTU # Physical unit number followed 

by /7 (seven-track) or 9/ (nine- 
track - default). 

RELATIVE ABSOLUTE: file and record 

OR ABSOLUTE? numbers are relative to 

beginning of tape. Must be 
positive. 

RELATIVE: file and record 
number are relative to current 
position. May be positive (for- 
ward) or negative (backward). 
= current position. 

FILE # OR Absolute file number of relative 

MT FILE number of records to forward or 

backspace. 

LOGICAL Number of bytes in a disk record. 

RECORD SIZE Must be 2K or less. 

BLOCKING FACTOR Number of logical records (line 
images) in one tape record. 

ASCII, BCD, Type of translation desired 

BINARY OR EBCDIC? between tape and disk. ASCII = 
none, BCD = BCD to ASCII, etc. 
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FULL OR PARTIAL? 

ENTER PARTS 
OF ...etc. 

OUTPUT FILENAME 

INPUT FILENAME 

'FROM' tape 
'TO' tape 



FULL = translate entire line. 

PARTIAL = translate specified 

fields. 

Enter starting/ending column 

numbers, one pair per line. 

Terminate with CR. 

Disk file to be created during 

READ. 

Disk file used as source of 

WRITE. 

MTU # of tape to be copied. 

MTU # of tape to relative copy. 



MAGNETIC TAPE RESTORE UTILITY 
MAGRST [-7TRK] 

Restores files, directory-trees or partitions from a mag- 
netic tape created with MAGSAV. Under PRIMOS III, IV 
or V the tape unit must be ASSIGNED. The MAGRST 
dialog is as follows: 

Possible Responses 

(0-7) Physical unit number 



Query 

TAPE UNIT: 

ENTER LOGICAL TAPE 

NUMBER: 



READY TO RESTORE: 



TREENAME: 



1 = 1st logical tape, 2 = 2nd 

etc. Rewinds and positions 

tape. = tape already 

positioned 

YES (Restore entire tape) 

NO (Request new tape 

drive and logical tape 

numbers) 

PARTIAL (Restore part of 

tape) 

$1 [filename] n print index to 

n levels to terminal or 

optional filename. 

NW n print n-level index at 

terminal but do not update 

disk (debugging] 

Enter treename for partial 

restore. 



MAGSAV 



41 



PRIMOS 



MAGNETIC TAPE SAVE UTILITY 
MAGSAV [option] 

Writes a PRIMOS disk file, directory-tree or partition to 7 

or 9-track magnetic tape. Under PRIMOS III, IV or V the 

tape unit must be ASSIGNed. 

Options: 

-LONG 1024-word records (default=512) 

-INC Incremental dump 

-UPDT Set DUMPED bit 

-7TRK 7-track tape format (defaulf=9 track) 

The MAGSAV dialog is as follows: 



Query 

TAPE UNIT: 

ENTER LOGICAL TAPE 

NUMBER: 



Possible responses 

(0-7) physical tape unit 



TAPE NAME: 
DATE: 

REV. NO: 
NAME: 



1 = 1st logical, 2 = 2nd, etc. 

Rewinds and repositions tape. 

= already positioned. 

Any number 

Valid date in format mm dd yy. 

[default = current date] 

Any number. 

filename to be saved or one of 

the following: 

$A Change home UFD. 

$Q Terminate logical tape 

and return to PRIMOS 

$R Do $Q and rewind tape. 

$1 [filename] n Index to n 

levels. 

MFD Save entire disk. 

(Must be attached to MFD) 

* Save current directory. 
Record Sizes: 448-word (PRIMOS) or 1024-word (Storage 
Module). 

PRIME MACRO ASSEMBLER 
PMA filename [option-1. . .option-n] 

-INPUT \ 

-listing! filename 

-BINARY ) 



tJAbll^/VM guiae. 
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Invokes Prime's Macro Assembler. For more information, 

refer to the PMA Programmer's Guide. 

Options: 

-EXPLIST Full assembly listing, reset A-register bit 

A2, set bit A3, force listing file 

generation. 
-ERRLIST Generate error only listing, reset bit A3, set 

bit A2, force listing file generation. 
-RESET Resets A, B, and X registers. 

SEGMENTATION UTILITY 
SEG treename 

Invokes SEG for loading, modifying and running seg- 
mented (V-mode) code. PRIMOS IV, V only. See the PMA 
manual. 

DELETE [filename] 
Deletes a saved SEG runfile. 
HELP 

Prints abbreviated list of SEG commands at terminal. 
[V]LOAD [treename] 

Defines runfile name and invokes virtual loader for crea- 
tion of new runfile. 
(VJLOAD * [treename] 

Specifies existing runfile and invokes virtual loader for 
appending. 

LOAD SUBPROCESSOR COMMANDS 
ATTACH [ufd-name] [password] [Idisk] [key] 
Attaches to directory. 

A/SYMBOL symbolname [segtype] segno size 

Defines a symbol in memory and reserves space for it 
using absolute segment numbers. 

COMMON Ir^l^'} segno 

Relocates COMMON using absolute or relative segment 
numbers. 

IL ^ 

LOAD 

LIBRARY 

FORCELOAD 

PL or RL 

Continues a load using parameters of previous LOAD 
Note: D/ and F/ may be combined, as in D/F/LI. 



D/ 
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[filename] 

[addr psegno Isegno] 



EXECUTE [a] [b [x] 

Saves loaded image on disk and executes program. 
/IL ^ 

LOAD 
F/ J LIBRARY 

FORCELOAD 

PL 

RL 

Forceloads all routines in object file. 
IL [addr psegno Isegno] 
Loads impure FORTRAN library IFTNLIB. 
INITIALIZE [treename] 
Initializes and restarts load subprocessor. 
LIBRARY [treename] [addr psegno Isegno] 
Loads library file (from LIB=UFD, if no treename 
specified). 

LOAD [treename] [addr psegno Isegno] 
Loads object file. 
MAP [filename] option 
Generates load map (see SEG - level MAP command). 



MIXUP 



I [ON] \ 
I OFF ( 



Mixes procedure and data in segments and permits 
loading of linkage and common areas in procedure seg- 
ments. Not reset by INITIATE. 
MV [start-symbol move-block desegno] 
Moves portion of loaded file (For libraries 
omitted, information is requested. 
OPERATOR option 

Enables or removes system privileges. = enable, 
remove. Caution: this command is intended only 
knowledgeable creators of specialized software. 
PL [addr psegno Isegno] 
Loads pure FORTRAN library, PFTNLB. 



If options are 



1 = 

for 



P/ 



/IL \ 

I LOAD I 

I LIBRARY I 



LOAD 

LIBRARY 
\ FORCELOAD < 

PL 
\RL / 



[filename] 

option [psegno] [Isegno] 
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Loads on a page boundary. The options are: PR = proce- 
dure only, DA = link frames only, none = both procedure 
and link frames. 
QUIT 

Returns to PRIMOS command level. 
RETURN 

Returns to SEG command level. 
RL treename [addr psegno Isegno] 
Replaces a binary module in an established runfile. 
R/SYMBOL symbolname [segtype] segno size 
Defines a symbol in memory and reserves space for it 
using relative segment assignment. (Default = data seg- 
ment). 

SAVE fa] [b] [x] 

Saves the results of a load on disk. 
SE segno length 

Creates base area for desectorization. 
SS symbol-name 

Saves symbol :prev,ents XPUNGE from deleting symbol- 
name. 

{segno addr | 

addr i 

addr ssegno saddr Isegno j 
Splits segment into data and procedure portions. Formats 
2 and 3 allow you to run from R mode; if all loaded infor- 
mation is in segment 4000. 
STACK size 

Sets minimum stack size. 
SYMBOL [sname] segno addr 

Defines a symbol at specific location in a segment. 
'IL ^ 

LOAD 
S/ j LIBRARY 

FORCELOAD 

PL 

■ ^^ 

Loads an object file in specified absolute segments. 

XP dsymbol dbase 

Expunges symbol from symbol table and deletes base 
information. 



[filename] 

addr psegno Isegno 



dsymbol Action 

delete only entry points, leaving COMMON 
areas 

1 delete all defined symbols - including 
COMMON area 

dbase Action 

retain all base information 

1 retain only sector zero information 

2 delete all base information 

End of LOAD subprocessor 

„.p itreename-l [treename-2] [map-option]y 

Prints a loadmap of treename-1 or current loadfile (*) at 
terminal or optional treename-2. 

options: 

Full map [default] 

1 Extent map only 

2 Extent map and base areas 

3 Undefined symbols only 

4 Full map (identical to 0) 

5 System programmer's map 

6 Undefined symbols, alphabetical order 

7 Full map, sorted alphabetically 

10 Symbols by ascending address 

11 Symbols alphabetically 

MODIFY [filename] 

Invokes MODIFY subprocessor to create a new runfile or 
mo|[ify an existing runfile. 

MODIFY SUBPROCESSOR COMMANDS 
NEW treename 

Writes a new copy of SEG runfile to disk. 

PATCH segno baddr taddr 

Adds a patch (loaded between baddr and taddr) to an 

existing runfile and saves it on disk. 

RETURN 

Returns to SEG command level. 
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SK 



ssize \ 

segno addr I 

ssize esegno | 

\ ssegno addr esegno ) 

Specifies stack size (ssize) and location, esegno specifies 

an extention stack segment. 

START segno addr 

Changes program execution starting address. 

WRITE 

Writes all segments above '4000 of current runfile to disk. 

End of MODIFY subprocvssor 

PARAMS [filename] 

Displays the parameters of a SEG runfile. 

PSD 

Invokes VPSD debugging utility. 

QUIT 

Returns to PRIMOS command level and closes all open 
files. 

RESTORE [treename] 

Restores a SEG runfile to memory for examination with 
VPSD. 

RESUME [treename] 
Restores runfile and begins execution. 
SAVE [treename] 
Synonym for MODIFY. 
SHARE [treename] 

Converts portions of SEG runfile corresponding to seg- 
ments below '4001 into R-mode-like runfiles. 
SINGLE [treename] segno 

Creates and R-mode-like runfile for any segment. 
TIME [treename] 

Prints time and date of last runfile modification. 
VERSION 

Displays SEG version number. 
VLOAD 
See LOAD. 

SPOOLER FOR PRINTER/PLOTTER 
SPOOL [treename] [option(s)] 

Queues disk files for line printer or plotter. For more 
information refer to the PRIMOS commands manual. 
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Options: 




-CANCEL PRTxxx 


Remove from spool queue 


-DEFER [time] 


Defer printing until specified time 


-EXPAND 


Expand compressed file before 




printing 


-FORM name 


Request to operator to load 




specified paper form 


-FTN 


Obey FORTRAN output 




conventions in file 


-FUNIT fileunit 


Specify From-unit (default = 1) 




range 1-16 


-HOME 


Do not print file on remote printer 




(for Primenet) 


-LIST option(s} 


List all specified spool-queue 




entries 


options 


meaning 


ALL 


All files (default) 


DEFER 


Deferred files 


FORM type 


Forms of specified type 




[default = ' ']. 


OWN 


Files spooled under users 




login name 


PLOT 


File in plot queue 


PRINT 


Files in print queue 


-LNUM 


Generate line numbers. 




Incompatible with FTN 




option. 


-NOFMT 


No format control (header, 




generation/pagination] User 




must inset own line-printer 




control codes 


-OPEN filename 2 


Open specified file on file unit 




2 for read-only 


-PLOT [nwords] 


Indicates plot file 




nwords is decimal number of 




words to be read/output per 




raster scan [default = 128, 




for 200 raster, inch plotter) 


-TUNIT fileunit 


Specify To unit. (1-16) 
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